home *** CD-ROM | disk | FTP | other *** search
/ PC Player 1995 March / PCP - 1995-03.iso / programm / dcc / dccv30.lzh / SCRIPT.DOC < prev    next >
Encoding:
Text File  |  1994-10-19  |  8.3 KB  |  285 lines
  1.  
  2.  
  3.  
  4.                 Dokumentation zur Erstellung eigener Dialoge
  5.                      für den Gebrauch im Anwendermenü
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12. 1. Wofür brauche ich das ?
  13. --------------------------
  14.  
  15.  Die Dialoge vereinfachen die Übergabe von Parametern an Programme.
  16.  Sie erlauben es auch dem unerfahrenen Anwender mit Programmen umzu-
  17.  gehen, die eine komplizierte Parameterübergabe erfordern.
  18.  Ähnliche Dialoge gab  es  auch  schon  bei  DCC  Version  1.8.  Diese
  19.  waren allerdings nicht so frei zu gestalten.
  20.  
  21.  Sie können mit diesen Dialogen beispielsweise Viren-Scanner steuern,
  22.  die sonst eine schwierige Parameterübergabe erfordern. Oder Sie er-
  23.  weitern die im DCC eingebauten Packer-Optionen nach den eigenen
  24.  Bedürfnissen. (siehe 5. Hinweise)
  25.  
  26.  
  27.  
  28.  
  29.  
  30. 2. Aufbau eines Dialog-Script's
  31. -------------------------------
  32.  
  33.  - Versionsinformation
  34.    DOS-COMMAND-CENTER-PRO 3.0   (für DCC V3.0 und DCC-PRO identisch)
  35.  - Dialogdefinition (Ausmaße, Überschrift etc.)
  36.    ■ DIALOG
  37.  - Kommandozeile
  38.    ■ COMMANDLINE
  39.  - BEGIN
  40.  - Dialogelemente
  41.  
  42.     ■ CANCELBUTTON
  43.     ■ CHECKBOX
  44.     ■ CONTROL
  45.     ■ INPUT
  46.     ■ LTEXT
  47.     ■ OKBUTTON
  48.     ■ RADIOBUTTON
  49.  
  50.  - END
  51.  
  52.  
  53.  
  54.  
  55.  
  56. 3. Beschreibung
  57. ---------------
  58.  
  59.  DOS-COMMAND-CENTER-PRO 3.0
  60.  
  61.  Die Versionsinformation muss in jedem Script enthalten sein und
  62.  muss in der ersten Zeile stehen. Auch wenn die Script-Dateien
  63.  unter DCC V3.0 genutzt werden, müssen die Dialoge diese Information
  64.  enthalten.
  65.  
  66.  DIALOG, 0,   5  1 75 21, "Datei(en) packen"
  67.  
  68.  Dies ist die Dialogdefinition. Erst wird der Typ eingetragen. In
  69.  diesem Fall immer  DIALOG.  Danach  wird  die  Nummer  des  Elementes
  70.  eingetragen (In diesem Fall immer 0). Hierauf folgen die Ausmaße  des
  71.  Dialogs in dem Format X1 Y1 X2 Y2
  72.  
  73.                  X1,Y1 ──────────── X2,Y1
  74.                    │                  │
  75.                    │                  │
  76.                  X1,Y2 ──────────── X2,Y2
  77.  
  78.  Sie  können  dabei  vom  Nullpunkt  ausgehen,  da  DCC  den    Dialog
  79.  automatisch auf dem Bildschirm zentriert.
  80.  Nach der Festlegung der Ausmaße folgt die Überschrift, die der Dialog
  81.  bekommen soll.
  82.  
  83.  COMMANDLINE "%4 %5 %6 %7%9 %13 %11"
  84.  
  85.  Diese Zeile beschreibt die Anordnung der Parameter, die die einzelnen
  86.  Dialogelemente zurückgeben.  Jedes  Element  im  Dialog  erhält  eine
  87.  eindeutige  Nummer.  Diese  Nummer  wird  hier  zusammen   mit    dem
  88.  Prozentzeichen "%" eingetragen. DCC ersetzt die Eintragung  dann  mit
  89.  dem entsprechenden Rückgabewert des Elementes. Es macht nur Sinn  die
  90.  Nummern von folgenden Elementtypen hier einzutragen :
  91.  
  92.  - INPUT
  93.  - CHECKBOX
  94.  - RADIOBUTTON
  95.  
  96.  Alle anderen  Elemente  geben  keine  Ergebnisse  zurück.  Falls  ein
  97.  Element keine Rückgabe  zuläßt  oder  z.B.  eine  Eingabezeile  keine
  98.  Eintragungen enthält, so wird die  entsprechende  Eintragung  in  der
  99.  COMMANDLINE einfach entfernt.
  100.  
  101.  Bei diesem Beispieldialog könnte die COMMANDLINE bei  Beendigung  des
  102.  Dialogs folgendermaßen aussehen:
  103.  
  104.  "-ex -3 -r -P -sPASSWORT C:\DCCPRO\TEST.ZIP *.EXE"
  105.     ^  ^    ^   ^   ^              ^           ^
  106.     │  │    │   │   │              │           │
  107.    %4 %5   %6  %7   %9            %13         %11
  108.  
  109.  
  110.  
  111. BEGIN
  112.  
  113.  Jede Dialogdefinition muss von BEGIN-END eingeschlossen sein.
  114.  
  115.  Folgende Elemente stehen zur Verfügung:
  116.  
  117.   - CONTROL
  118.  
  119.     Dies ist das Label/die Überschrift für ein anderes Element.
  120.     Mit diesem Elementtyp können  Sie  beispielsweise  eine  Eingabe-
  121.     zeile beschreiben und anwählen.
  122.  
  123.     Aufbau :
  124.  
  125.     TYP, Nummer des Elementes, Position, Text, verknüpftes Element
  126.  
  127.     Beispiel :
  128.  
  129.     CONTROL      ,  3, 46  2 59  3, "~K~ompression",  4
  130.  
  131.   - RADIOBUTTON
  132.  
  133.     Mit diesem Element wird eine eindeutige Auswahl getroffen. Man
  134.     kann mehrere Einträge zur Auswahl anbieten, es kann jedoch nur
  135.     einer gewählt werden. Es ist weiterhin nicht möglich keinen Eintrag
  136.     auszuwählen.
  137.  
  138.     Aufbau :
  139.  
  140.     TYP, Nummer des Elementes, Position, Anzahl der Einträge,
  141.     Einträge, Rückgabewerte der Einträge
  142.  
  143.     Beispiel :
  144.  
  145.     RADIOBUTTON , 4, 40  3 66  8,  5, "maximal"  "normal"  "schnell"
  146.                   "sehr schnell" "keine", " -ex" " -en" " -ef" " -es" " -e0"
  147.  
  148.   - CHECKBOX
  149.  
  150.     Dieser Typ ist ähnlich aufgebaut, wie der vorherige. Hier können
  151.     jedoch mehrere Einträge angewählt werden. Außerdem ist es hier
  152.     möglich keinen der Einträge auszuwählen.
  153.  
  154.     Der Aufbau ist der gleiche, wie beim Typ RADIOBUTTON
  155.  
  156.     Beispiel :
  157.  
  158.     CHECKBOX   , 5,  4    8  36  10,  2,  "keine  ~3~2-Bit
  159.                 Unterstützung" "k~e~ine DPMI Unterstützung", " -3" " -)"
  160.  
  161.  
  162.  
  163.   - INPUT
  164.  
  165.     Der Typ INPUT stellt eine Eingabezeile dar. Hier können beliebige
  166.     max. 255 Zeichen lange Texte übergeben werden. Der Eingabezeile
  167.     können Standardeintragungen übergeben werden, die beim Aufruf des
  168.     Dialogs in die Eingabezeile eingefügt werden. Hier ist es auch
  169.     möglich mit den von DCC bekannten Platzhaltern "!:!\!.!" zu arbeiten.
  170.     DCC ersetzt diese dann durch den Namen der gerade im Dateifenster
  171.     gewählten Datei.
  172.  
  173.     Aufbau :
  174.  
  175.     TYP, Nummer des Elementes, Position, Standardtext
  176.  
  177.  
  178.     Beispiel :
  179.  
  180.     INPUT        , 11, 16  5 35  6, "!:!\!.!"
  181.  
  182.  
  183.   - LTEXT
  184.  
  185.     Dieser Elementtyp dient ausschließlich dazu, Text darzustellen.
  186.  
  187.     Aufbau :
  188.  
  189.     TYP, Nummer des Elementes, Position, Text
  190.  
  191.     Beispiel :
  192.  
  193.     LTEXT,  3, 46  2 59  3, "Dieser Dialog ist ein Beispieldialog!"
  194.  
  195.   - CANCELBUTTON
  196.  
  197.     Dies ist der Schaltknopf um einen Abbruch des Dialogs zu bewirken.
  198.     Hier können Sie einen beliebigen Text eintragen.
  199.  
  200.     Aufbau :
  201.  
  202.     TYP, Nummer des Elementes, Position, Beschriftung
  203.  
  204.     Beispiel :
  205.  
  206.     CANCELBUTTON ,  1, 53 16 66 18, "~A~bbruch"
  207.  
  208.  
  209.   - OKBUTTON
  210.  
  211.     Dies ist der Schaltknopf um einen Dialog normal zu beenden. Der
  212.     Dialog wird dann geschlossen, die Kommandozeile aufgebaut und
  213.     ausgeführt.
  214.  
  215.     Der Aufbau ist mit dem des CANCELBUTTON indentisch.
  216.  
  217.     Beispiel :
  218.  
  219.     OKBUTTON     ,  2, 40 16 51 18, "~S~tart"
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227. 4. Beispieldialog
  228. -----------------
  229.  
  230. Dieser Dialog dient zum Archivieren von einzelnen oder
  231. markierten Dateien mit PKZIP Version 2.04.
  232. -----------------------------------------------------------------------------
  233.  
  234. DOS-COMMAND-CENTER-PRO 3.0
  235. DIALOG, 0,   5  1 75 21, "Datei(en) packen"
  236. COMMANDLINE "%4 %5 %6 %7%9 %13 %11"
  237. BEGIN
  238.          CONTROL      ,  3, 46  2 59  3, "~K~ompression",  4
  239.          RADIOBUTTON  ,  4, 40  3 66  8,  5, "maximal" "normal" "schnell"
  240.          "sehr schnell" "keine", " -ex" " -en" " -ef" " -es" " -e0"
  241.          CHECKBOX     ,  5,  4  8 36 10,  2, "keine ~3~2-Bit Unterstützung"
  242.          "k~e~ine DPMI Unterstützung", " -3" " -)"
  243.          CHECKBOX     ,  6,  4 15 36 18,  3, "mit ~U~nterverzeichnissen"
  244.          "~m~arkierte Dateien packen" "~V~erzeichnisnamen speichern",
  245.          " -r" " @^ZIP.LST" " -P"
  246.          CHECKBOX     ,  7,  4 12 36 13,  1, "~P~asswort benutzen", " -s"
  247.          CONTROL      ,  8, 40 11 48 12, "Paß~w~ort",  9
  248.          INPUT        ,  9, 40 12 65 13, ""
  249.          CONTROL      , 10,  4  5 15  6, "~D~ateimaske", 11
  250.          INPUT        , 11, 16  5 35  6, "!:!\!.!"
  251.          CONTROL      , 12,  4  3 15  4, "A~r~chivname", 13
  252.          INPUT        , 13, 16  3 35  4, "!:!\!..ZIP"
  253.          CANCELBUTTON ,  1, 53 16 66 18, "~A~bbruch"
  254.          OKBUTTON     ,  2, 40 16 51 18, "~S~tart"
  255. END
  256.  
  257. -----------------------------------------------------------------------------
  258.  
  259. 5. Hinweise
  260. -----------
  261.  
  262. Sie haben die Möglichkeit DCC zu veranlassen eine Dateiliste mit den
  263. gewählten/markierten Dateien zu erstellen. Diese Liste kann dann anderen
  264. Programmen z.B. Packern (PKZip, ARJ etc.) übergeben werden.
  265. Diese Liste wird mit Ascii 94 "^" gekennzeichnet und kann einen beliebigen
  266. Namen haben.
  267.  
  268. Der Einbau einer solchen Dialogdatei im Anwendermenü kann beispielsweise
  269. folgendermaßen aussehen:
  270.  
  271. MENUITEM "~P~acken mit PKZip..." NOKEY "PKZIP &C:\DCCPRO\PKZIP.SCR" _EXECWIN
  272.  
  273. Das Asciizeichen 38 "&" wird dabei dem Namen der Dialogdatei vorangestellt.
  274. Hieran erkennt DCC, daß es sich bei dem folgenden Namen um eine Scriptdatei
  275. handelt.
  276.  
  277. Die Scriptdatei kann an beliebiger Stelle in der Menü-Kommandozeile einge-
  278. tragen werden. Es ist auch möglich nur die Scriptdatei als Kommando einzu-
  279. tragen. Dann wird die Kommandozeile vollständig aus dem Dialog gebildet.
  280.  
  281.  
  282.  
  283.  
  284.  
  285.